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© Network management agent with user created objects. 



© A computer network management software agent 
which includes the ability for users to add new user 
defined management objects. A user editable text 
file (208) defines object identifications (302, 306), 
object types (312), and the path and name of asso- 
ciated executable software (308, 314). A user can 
then invoke user defined executable software at a 
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managed node (104, 108) by sending a network 
command and a user defined associated object 
identifier to the agent (106, 110, 200) in the man- 
aged node. Data can be sent between a user and 
user defined executable software. A timeout feature 
generates an error if commands are not completed 
within a user defined time. 
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FIELD OF INVENTION 

This invention relates generally to computer 
networks, and more particularly to network man- 
agement software. 5 

BACKGROUND OF THE INVENTION 

Computers may be interconnected via a local 
area network (LAN). Local area networks may be w 
interconnected into still larger systems spanning a 
floor or building, a group of buildings (campus), a 
region, or larger areas on up to worldwide systems. 
Each LAN may have a different hardware intercon- 
nection technology and multiple network protocols. ;5 
A simple isolated LAN may be administered by 
individual users. That is, users may change equip- 
ment, install software, and diagnose problems. 
Large complex LANs or large groups of intercon- 
nected LANs require "management". 20 
"Management" refers to both a human network 
manager and software used by the human man- 
ager. In this application, "management" refers to 
software for managing the overall system, and 
"user" refers to a person using the network man- 25 
agement software. The user is usually the system 
administrator. Users can obtain management data 
and alter management data on the network by 
using network management software. 

Large network systems are typically dynamic 30 
with continual requirements for addition and dele- 
tion of equipment, updating of software, and detec- 
tion and analysis of problems. In general, there 
may be a variety of systems from a variety of 
vendors with a variety of system owners. Manage- 35 
ment software is designed to be as general as 
possible. However, as the overall system changes, 
the user may need information or control capabil- 
ities not anticipated by the designers of the man- 
agement software. Management software needs to 40 
have a provision for adding new user defined capa- 
bilities for information gathering and control. 

Current network management software is typi- 
cally defined in terms of software objects. A soft- 
ware object is a way of organizing data. An object 45 
may have a value or associated data. An object 
may have an associated executable software pro- 
cess for generating data or for control purposes. A 
user can retrieve or alter the data associated with 
an object. Network management objects are 50 
uniquely identified by object identifiers. 

An agent is software running as a background 
process on each of the target devices. When a 
user requests management data from a device on 
the network, management software will send an 55 
object identification in a management packet or 
frame to the target agent. The agent will interpret 
the object identification, retrieve data associated 



with the object identification, and send the data in a 
packet back to the user. Sometimes, a correspond- 
ing process may be invoked to retrieve data. 

Current network management agent software is 
typically sold with a hierarchy of fixed pro-defined 
objects. There are typically no provisions for a user 
to add or modify objects. Some management soft- 
ware provides "extensible" agents. "Extensible" 
typically means that a user has access to source 
code for the agent and can modify the source code 
and recompile. Alternatively, the user may write 
additional code in a programming language which 
requires compilation but may not be required to 
recompile the original agent In either case, writing 
source code in a programming language and com- 
pilation of the source code is required. There is a 
need for users to have the capability to add objects 
and associated processes without having to write 
code in a programming language requiring com- 
pilation. 

There are numerous standards organizations 
which are attempting to standardize computer net- 
working. The International Organization for Stan- 
dardization (ISO) has provided a general reference 
framework called the Open System Interconnection 
(OSI) model. The OSl model for a network man- 
agement protocol is called Common Management 
Information Protocol (CMIP). CMIP is a common 
network management protocol in Europe. In the 
United States, a more common network manage- 
ment protocol is a related variation of CMIP called 
the Simple Network Management Protocol (SNMP) 
(see Marshall T. Rose, The Simple Book, Prentice- 
Hall, 1991). ~ 

In the SNMP network management terminol- 
ogy, a network management system contains at 
least one network management station (NMS), sev- 
eral managed nodes, each containing an agent, 
and a network management protocol which is used 
by the management station and the agents to ex- 
change management information. A user can obtain 
data and alter data on the network by using net- 
work management software on the NMS to commu- 
nicate with agent software in the managed nodes. 

Software for agents conforming to SNMP stan- 
dards is commercially available. Agent source code' 
is also available without charge from universities. 
For example, a source code SNMP development 
kit (hereinafter referred to as the "MIT code") is 
available from the following source: 

James R. Davin 

Advanced Network Architecture Group 
M.l.T. Laboratory for Computer Science 
545 Technology Square 
Cambridge, MA 02139 

The SNMP defines a structure for a manage- 
ment database (a collection of objects) called the 
Management Information Base (MIB). Objects in a 
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MIB have names (OBJECT IDENTIFIERS) and data 
structures (OBJECT TYPES). An object identifier is 
a sequence of non-negative integer values which 
signify a path through a tree structure of numbered 
branches (called sub-identifiers). Each sub-iden- 
tifier is a non-negative integer. For example, the 
object identifier 1.3.6.1.4.1.11.2.12 identifies an ob- 
ject found by starting at the root, moving to the 
branch with the sub-identifier 1, moving to a subor- 
dinate branch with the sub-identifier 3, and so forth. 
The first 6 levels of this example are defined by 
the standard model. In the example, the branch 
identified by the first five sub-identifiers (1.3.6.1.4) 
is the standard SNMP defined branch called 
"private". The next sub-identifier (1) is for a branch 
(called "enterprises ") reserved for vendor specific 
objects. The next label (11) is reserved for Hewlett 
Packard. 

Information is retrieved from an agent by send- 
ing a SNMP GET or GET-NEXT request with an 
object identification as a parameter. Data asso- 
ciated with an object can be altered by sending a 
SNMP SET request to the agent with the object 
identification as one parameter and the data as 
another parameter. An object which can be written 
to is called a "settable" object. 

The MIT code includes a function (named 
"misExportO") for registering (attaching or grafting) 
an object to the object tree structure. There are 4 
parameters as follows: 

name: (the object identifier) 

namelen: (the number of sub-identifiers in 

the object identifier) 
ops: (a list of 6 routines (corresponding 

to the operations RELEASE, CRE- 
ATE, DESTROY, and SNMP re- 
quests GET-NEXT, GET, and SET) 
which can be performed on man- 
agement objects) 
cookie: (a pointer ta stored parameters as- 
sociated with the specific object 
identifier within a data structure in- 
ternal to the agent). 
MIB standards evolve as required by the in- 
dustry. Proposed MIB standards start as published 
requests for comments. A MIB format for defining 
objects is specified in Request For Comments 
number 1212 (hereinafter referred to as "RFC 
1212") and an example MIB standard using that 
format is specified in Request For Comments 1213 
(hereinafter referred to as "RFC 1213"). Both are 
available from the following source: 
DON Network Information Center 
SRI International 
Room EJ291 

333 Ravenswood Avenue 
Menlo Park, CA 94025 

The RFC 1212 object-type notation requires a 



series of textual clauses as follows: 
SYNTAX: 

(examples are "INTEGER" and "OCTET 
STRING") 
5 ACCESS: 

(choices are: "read-only", "read-write", "write- 
only", and "not-accessible") 
STATUS: 

(the required choice for status in a commercial 
w product is "mandatory". In an experimental MIB. 
the word "optional" is allowed.) 
DESCRIPTION: 

(A textual explanation of the object delimited by 
quote marks.) 

75 As discussed above, there is a need in network 

management for users to have the capability of 
adding management objects to an agent without 
requiring recompilation. However, the capability 
must be compatible with various standards as de- 

20 scribed above. 

SUMMARY OF THE INVENTION 

The present invention provides a network man- 

25 agement agent having the capability of adding new 
objects to the agent without requiring modification 
of the agent source code and without stopping and 
restarting the agent. These new objects can then 
be used by network management users to initiate 

30 user defined processes. 

In the present invention, user defined objects 
are defined in a configuration file which is read by 
a network management agent. The configuration 
file is an editable text file which can be created at 

35 any time. The agent can be invoked to re-read the 
configuration file and incorporate objects in the 
configuration file. Then, if a request for a user 
defined object reaches an agent, the appropriate 
user defined process is initiated to acquire data, 

40 control a peripheral, or execute whatever is re- 
quested. Data is returned from the user defined 
process back through the agent to the user. A 
timeout feature generates an error if commands are 
not completed within a user defined time. 

45 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a block diagram illustrating a com- 
puter network. 

so Figure 2 is a software block diagram illustrating 

additional detail within an agent. 

Figure 3 illustrates an example agent configu- 
ration file in accordance with the present invention. 
Figure 4 illustrates pseudocode for reading a 
55 configuration file and registering user defined ob- 
jects with a vendor defined object tree structure. 
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DETAILED DESCRIPTION OF THE PREFERRED 
EMBODIMENT OF THE INVENTION 

Figure 1 illustrates a computer network 100. 
Network management station 102 manages a vari- 
ety of managed nodes 104, 108. Each managed 
node has an agent 106, 110 running as background 
software providing management information and 
control. Each agent 106, 110 is configured as a 
tree structure of software objects. 

Figure 2 illustrates additional detail within an 
agent. Agent 200 has a layer of standard objects 
202 defined by RFC 1213, and a layer of vendor 
defined objects 204. Standard objects 202 and 
vendor defined objects 204 are compiled and sup- 
plied by the network management software vendor. 
The present invention comprises software within an 
agent 200 enabling the addition of user defined 
objects 206 to a previously compiled network man- 
agement agent 200. User defined objects are de- 
fined in configuration file 208. Agent 200 can be 
invoked to re-read configuration file 208 and add 
user defined objects 205 to agent 200. 

The preferred embodiment of the present in- 
vention is an agent conforming to the SNMP 
model. Much -of the following structure and no- 
menclature is common to other standards but is 
presented here specifically in terms of the SNMP. 
The preferred embodiment of the present invention 
uses the MIT code for the basic core of the agent 
software. 

The new agent in the present invention in- 
cludes the capability of reading object definitions 
from a special file called a configuration file (208 in 
figure 2). The configuration file (208) is a text file 
which can be edited by a user using any text 
editor. The configuration file (208) can be defined 
at the time the new agent is installed or may be 
defined later. The configuration file (208) has a 
predefined UNIX path. 

The configuration file is compatible with the 
RFC 1212 MIB standard described earlier. How- 
ever, in the preferred embodiment, additional capa- 
bility is incorporated into the textual DESCRIPTION 
clause. Four additional clauses are defined as fol- 
lows: 

READ-COMMAND: 

(a path and name for an executable program.) 
WRITE-COMMAND: 

(a path and name for an executable program.) 
READ-COMMAND-TIMEOUT: 
(an integer specifying a time in seconds allowed 
for completion of a READ-COMMAND.) 
WRITE-COMMAND-TIMEOUT: 
(an integer specifying a time in seconds allowed 
for completion of a WRITE-COMMAND). 
Figure 3 illustrates a sample configuration file. 
The object identifier preamble (302) defines a MIB 



tree structure branch common to all user defined 
objects. In the sample illustrated in figure 3. the 
common branch is 1.3.6.1.4.1.58. Then, for each 
defined object, the list defines a leaf which can be 

5 combined with the common branch to define each 
object's SNMP name (object identifier). For exam- 
ple, an object labeled "printerstatus" (304) defines 
a leaf (306) which appends the sub-identifier 1 to a 
branch labeled "xyzprinter" which in turn is as- 

70 signed the integer 1 in the preamble (302). The 
complete object identifier for the user defined ob- 
ject labeled "printerstatus" is then 
1.3.6.1.4.1.58.1.1.0. The object labeled 
"printerstatus" (304) could be used to turn a printer 

75 on and off and to test the status of the printer. A 
request to read the printer status is initiated by a 
SNMP GET or GET-NEXT request to the agent 
along with the object identifier. The agent invokes a 
user specified program designated in the read- 

20 command clause (308). The read-command clause 
(308) specifies a UNIX path /usr/ local/bin/ and an 

executable program named "printer status". The 

read-command-timeout clause (31 0) specifies that 
the agent will only wait 10 seconds for the 

25 printer status command to respond. If the com- 
mand takes longer than 10 seconds, an error mes- 
sage is returned to the management station. The 
syntax clause (312) specifies that if the printer is 
on line (up), the object labeled "printerstatus" re- 

30 turns the integer 1 to the management station. If 
the printer is off line (down), a 2 is returned. 
Likewise, a command to force the printer off line is 
accomplished by sending an integer argument 2 
(down) to the user defined object "printerstatus" 

35 which in turn passes the argument and invokes a 
program named "change printer status" as de- 
fined in the write-command clause (314). 

Figure 3 also illustrates a read-only object 
labeled "printertype" (316) to return a description 

40 string identifying a printer type. Also illustrated in 
figure 3 is a read-only object labeled "user-logins" 
(318) to return a string containing identifications of 
all users currently logged onto the network. Con- 
tinuing in figure 3. the last example is a read-only 

45 object labeled "numusers" which returns the num- 
ber of users logged onto the network. 

Figure 4 illustrates in comments and pseudo- 
code the code which enables an agent to read the 
objects described in the configuration file, to parse 

so the special clauses within the description clause, to 
associate user specified executable software with a 
user defined object identifier, and to graft the user 
defined object to the primary tree structure that is 
defined by the vendor when the agent code is 
55 compiled. The misExport function described in the 
background section is called to graft the user de- 
fined object to the primary tree structure. The 
misExport function is executed once for each user 
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defined object. 

In figure 4. the human readable configuration 
file is read (402) and information associated* with 
each object is then saved in a separate internal 

data structure named "saved values" (404). Then 

the misExport function is called to register the 
object (406). The ops parameter for the misExport 
function requires procedure names for responding 
to the SNMP GET, GET-NEXT, and SET requests. 
In figure 4, these are labeled "get^routine" (408), 
"getNext_routine" (410), and "set^routine" (412) 
respectively. 

Get_/outine (408) is called when a SNMP 
GetRequest is received by the agent for one of the 
objects registered from the configuration file. 
Get_routine (408) uses the misExport cookie pa- 
rameter (414) as a pointer into an internal data 
structure to identify the path and name of a UNIX 
shell command. The UNIX shell command will ex- 
ecute read routine and read timeout (402) as 

specified in the original configuration file. The 

getNext routine (412) and the set__routine (412) 

also use the cookie parameter (414) to point to a 
UNIX shell command which executes user speci- 
fied procedures. 

Once an object is defined for an agent, a user 
at the network management station can then re- 
quest data from that agent (e.g., an integer or a 
string) or initiate a process within that agent 
(settable object). The user invokes the user-defined 
object by sending an SNMP request with an object 
identifier and appropriate data arguments to the 
agent containing the object. 

" At start-up, an agent searches for and reads 
the configuration file. Once the configuration file is 
read, the information is incorporated into the 
agent's memory and the actual file is no longer 
needed. Therefore, the file can be modified while 
the agent is running. Also, the file can be incor- 
porated without requiring _ recompilation of the 
agent. After start-up, the agent can be reconfigured 
(forced to re-read all configuration files) by issuing 
an SNMP SetRequest to an object having the ob- 
ject identifier 1.3.6.1.4.1.11.2.13.2.2.0 and setting 
the value to 1. This vendor-specific settable object 
exists in previous Hewlett Packard UNIX versions 
of SNMP compatible agents. The reconfigure ob- 
ject first unregisters all user defined objects pre- 
viously registered. Then the process of reading the 
configuration file and registration proceeds as de- 
scribed in figure 4. 

From the preceding discussion, it can be seen 
that the present invention provides a network man- 
agement agent to which a user can add new man- 
agement objects. The new user defined objects 
can be added without requiring recompilation of the 
agent and can be added without stopping the 
agent. This capability permits the user to expand 



the agent's capability into areas not provided by 
the vendor for the agent. The agent can then be 
updated, or it can be modified to accommodate 
new software or new equipment, or it can be im- 

5 proved to provide management tools not contem- 
plated by the designers of the agent. 

The foregoing description of the present inven- 
tion has been presented for purposes of illustration 
and description. It is not intended to be exhaustive 

/o or to limit the invention to the precise form dis- 
closed, and other modifications and variations may 
be possible in light of the above teachings. The 
embodiment was chosen and described in order to 
best explain the principles of the invention and its 

is practical application to thereby enable others 
skilled in the art to best utilize the invention in 
various embodiments and various modifications as 
are suited to the particular use contemplated. It is 
intended that the appended claims be construed to 

20 include other alternative embodiments of the inven- 
tion except insofar as limited by the prior art. 

Claims 

25 1. In a computer network having network man- 
agement software, said network having at least 
one managed node (104, 108), said managed 
node having an agent means (106. 110. 200), 
running as background software, for providing 

30 management information and management 

control for said managed node, a process for 
adding user defined software objects (206) to 
said agent means and for invoking said user 
defined objects, the process comprising the 

35 following steps: 

defining at least one object identification in 
a configuration text file (208) in a particular 
agent by entering a user defined object iden- 
40 tifier (302, 306), an object type (312). and a 

directory path (308, 314) for an associated 
executable program; 

reading said configuration file by said par- 
45 ticular agent when said particular agent is 

started (402); 

incorporating information from said con- 
figuration file into a management information 
so base within said particular agent (404, 406); 

re-reading said configuration file and re- 
incorporating information from said configura- 
tion file into said management information 
55 base when a reconfigure command is re- 

ceived; 

sending a network management command 
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10 



and said object identification and a first data 
parameter, if said object type requires data, 
from a user to said particular agent; 

receiving said network management com- s 
mand and said object identification and said 
first data parameter by said particular agent; 

finding said object identification, by said 
particular agent, in said management informa- io 
tion base; 

initiating said associated executable pro- 
gram and sending said first data parameter to 
said associated executable program by said 75 
particular agent; 

returning a second data parameter from 
said executable program by said agent to said 
user if said object type requires returned data. 20 

2. In a computer network having network man- 
agement software, said network having at least 
one managed node (104, 108); 

25 

agent means (106, 110, 200), running as 
background software in said managed node, 
for providing management information and 
management control for said managed node, 
said agent means further comprising: 30 

configuration file means (208) far defining 
management software objects, said configura- 
tion file means comprising an editable text file; 

35 

said configuration file means further com- 
prising at least one object definition (304, 31 6, 
318, 320); 

configuration file reading means (402, 404, 40 
406) for incorporating said configuration file 
means into a management information base 
within said agent means when said agent 
means is started; 

45 

reconfiguration means for re-reading and 
re-incorporating said configuration file means 
when a reconfiguration command is received. 

3. A computer network management agent so 
means as in claim 2 wherein said object defini- 
tion further comprises an object identification 
(302, 306), an object type identification (312) 

and at least one directory path (308, 314) for 

an associated executable software program. 55 

4. A computer network management agent 
means as in claim 3 wherein said object defini- 



tion further comprises a textual description 
clause. 

5. A computer network management agent 
means as in claim 4 wherein said directory 
path is specified in a read-command clause 
(308) in said textual description clause. 

6. A computer network management agent 
means as in claim 4 wherein said textual de- 
scription clause further comprises a read- 
command-timeout clause (310). 

7. A computer network management agent 
means as in claim 4 wherein said directory 
path is specified in a write-command clause 
(314) in said textual description clause. 

8. A computer network management agent 
means as in claim 4 wherein said textual de- 
scription clause further comprises a write- 
command-timeout clause. 

9. A computer network management agent 
means as in any one of claims 5, 6, 7, or 8 
wherein said agent means further comprises: 

management information base reading 
means for matching said object identification 
from said management software to said object 
defined in said management information base; 

program initiating means for initiating said 
associated executable software program; 

send-data transfer means for transferring 
data from said management software to said 
associated executable software program; 

get-data transfer means for transferring 
data from said associated executable software 
program to said management software. 
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